[アップデート]Amazon Connectのエージェントステータスへの変更がCloudTrail のイベントとして記録されるようになりました

#Amazon Connect

#AWS

繁松昂大

2025.01.14

こんにちは。
繁松です。

はじめに

Amazon Connectのエージェントステータスへの変更をCloudTrailのイベントとして記録できるようになりました。
ステータスの追加、更新、無効化などのイベントを記録できます。
Amazon Connect が提供されているすべての AWS リージョンで利用可能です。
※Amazon Connectのステータスは削除することができません。

Amazon Connectの管理コンソール上でも変更履歴を確認できましたが、CloudTrailに記録できるようになったことで、ステータスの作成や変更を通知することが可能となりました。

確認してみた

ステータスの作成

ステータス作成時に記録されるイベントレコード。
testという名前のステータスを作成しました。

ステータスを作成したAmazon Connectユーザー名は表示されず、[userIdentity]の[principalId]にユーザーIDが表示されます。
送信元のIPアドレスは[connect.amazonaws.com]で記録されます。

{
    "eventVersion": "1.09",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AROA3IBXDG7DHNDXPL7WZ:5e5b4687-c5e5-4fcc-b9e8-df6129003653",
        "arn": "arn:aws:sts::AWSアカウントID:assumed-role/AWSServiceRoleForAmazonConnect_hbflSmp0ABg33YOJjC1K/5e5b4687-c5e5-4fcc-b9e8-df6129003653",
        "accountId": "AWSアカウントID",
        "accessKeyId": "ASIA3IBXDG7DNYKI64J5",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AROA3IBXDG7DHNDXPL7WZ",
                "arn": "arn:aws:iam::AWSアカウントID:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_hbflSmp0ABg33YOJjC1K",
                "accountId": "AWSアカウントID",
                "userName": "AWSServiceRoleForAmazonConnect_hbflSmp0ABg33YOJjC1K"
            },
            "attributes": {
                "creationDate": "2025-01-13T06:01:12Z",
                "mfaAuthenticated": "false"
            }
        },
        "invokedBy": "connect.amazonaws.com"
    },
    "eventTime": "2025-01-13T06:01:12Z",
    "eventSource": "connect.amazonaws.com",
    "eventName": "CreateAgentStatus",
    "awsRegion": "ap-northeast-1",
    "sourceIPAddress": "connect.amazonaws.com",
    "userAgent": "connect.amazonaws.com",
    "requestParameters": {
        "InstanceId": "インスタンスID",
        "State": "ENABLED",
        "Name": "test"
    },
    "responseElements": {
        "AgentStatusARN": "arn:aws:connect:ap-northeast-1:AWSアカウントID:instance/インスタンスID/agent-state/34fdd2eb-395e-483d-91f4-6147db426956",
        "AgentStatusId": "34fdd2eb-395e-483d-91f4-6147db426956"
    },
    "requestID": "9d05831e-b4b7-4fdc-a120-85931ba58edb",
    "eventID": "fff3f1e6-dc4e-48cc-95e2-c8724a5d57b4",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "AWSアカウントID",
    "eventCategory": "Management"
}

ステータスの更新

ステータス更新時に記録されるイベントレコード。

{
    "eventVersion": "1.09",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AROA3IBXDG7DHNDXPL7WZ:5e5b4687-c5e5-4fcc-b9e8-df6129003653",
        "arn": "arn:aws:sts::AWSアカウントID:assumed-role/AWSServiceRoleForAmazonConnect_hbflSmp0ABg33YOJjC1K/5e5b4687-c5e5-4fcc-b9e8-df6129003653",
        "accountId": "AWSアカウントID",
        "accessKeyId": "ASIA3IBXDG7DBVOSZ5VU",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AROA3IBXDG7DHNDXPL7WZ",
                "arn": "arn:aws:iam::AWSアカウントID:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_hbflSmp0ABg33YOJjC1K",
                "accountId": "AWSアカウントID",
                "userName": "AWSServiceRoleForAmazonConnect_hbflSmp0ABg33YOJjC1K"
            },
            "attributes": {
                "creationDate": "2025-01-13T08:11:07Z",
                "mfaAuthenticated": "false"
            }
        },
        "invokedBy": "connect.amazonaws.com"
    },
    "eventTime": "2025-01-13T08:17:17Z",
    "eventSource": "connect.amazonaws.com",
    "eventName": "UpdateAgentStatus",
    "awsRegion": "ap-northeast-1",
    "sourceIPAddress": "connect.amazonaws.com",
    "userAgent": "connect.amazonaws.com",
    "requestParameters": {
        "Description": "***",
        "InstanceId": "インスタンスID",
        "AgentStatusId": "34fdd2eb-395e-483d-91f4-6147db426956"
    },
    "responseElements": null,
    "requestID": "b6605a6a-8549-4ab2-8b06-a1b4c662ba16",
    "eventID": "cea479bb-9fd4-4c5a-8cda-4cd4b4f0e39e",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "AWSアカウントID",
    "eventCategory": "Management"
}

ステータスの無効化

ステータス無効化時に記録されるイベントレコード。

{
    "eventVersion": "1.09",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AROA3IBXDG7DHNDXPL7WZ:5e5b4687-c5e5-4fcc-b9e8-df6129003653",
        "arn": "arn:aws:sts::AWSアカウントID:assumed-role/AWSServiceRoleForAmazonConnect_hbflSmp0ABg33YOJjC1K/5e5b4687-c5e5-4fcc-b9e8-df6129003653",
        "accountId": "AWSアカウントID",
        "accessKeyId": "ASIA3IBXDG7DHG3HZDSL",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AROA3IBXDG7DHNDXPL7WZ",
                "arn": "arn:aws:iam::AWSアカウントID:role/aws-service-role/connect.amazonaws.com/AWSServiceRoleForAmazonConnect_hbflSmp0ABg33YOJjC1K",
                "accountId": "AWSアカウントID",
                "userName": "AWSServiceRoleForAmazonConnect_hbflSmp0ABg33YOJjC1K"
            },
            "attributes": {
                "creationDate": "2025-01-14T00:21:30Z",
                "mfaAuthenticated": "false"
            }
        },
        "invokedBy": "connect.amazonaws.com"
    },
    "eventTime": "2025-01-14T00:21:34Z",
    "eventSource": "connect.amazonaws.com",
    "eventName": "UpdateAgentStatus",
    "awsRegion": "ap-northeast-1",
    "sourceIPAddress": "connect.amazonaws.com",
    "userAgent": "connect.amazonaws.com",
    "requestParameters": {
        "InstanceId": "インスタンスID",
        "State": "DISABLED",
        "AgentStatusId": "34fdd2eb-395e-483d-91f4-6147db426956"
    },
    "responseElements": null,
    "requestID": "4f5aabff-33b3-473e-94fe-8eeff7bd85f7",
    "eventID": "0ca37d93-3a7e-4e29-8975-11dfabcc8135",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "managementEvent": true,
    "recipientAccountId": "AWSアカウントID",
    "eventCategory": "Management"
}

ユーザーIDの確認方法

ユーザーIDは以下のAWS CLIコマンドで確認することができます。

aws connect list-users --instance-id インスタンスID

結果

{
    "UserSummaryList": [
        {
            "Id": "2ceac716-a8c7-496f-ad95-ac5f7489faf9",
            "Arn": "arn:aws:connect:ap-northeast-1:AWSアカウントID:instance/インスタンスID/agent/2ceac716-a8c7-496f-ad95-ac5f7489faf9",
            "Username": "shigematsu",
            "LastModifiedTime": "2024-12-04T05:06:17.400000+00:00",
            "LastModifiedRegion": "ap-northeast-1"
        },
        {
            "Id": "5e5b4687-c5e5-4fcc-b9e8-df6129003653",
            "Arn": "arn:aws:connect:ap-northeast-1:AWSアカウントID:instance/インスタンスID/agent/5e5b4687-c5e5-4fcc-b9e8-df6129003653",
            "Username": "test1234",
            "LastModifiedTime": "2025-01-13T06:00:47.279000+00:00",
            "LastModifiedRegion": "ap-northeast-1"
        }
    ]
}